home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 007a / samdsk.zip / SAMDISK.DOC < prev    next >
Text File  |  1992-01-02  |  9KB  |  248 lines
  1. Samdisk V1.0 - by Pete Lyall
  2. January 2, 1992
  3.  
  4. What is samdisk?
  5. ================
  6.  
  7. Samdisk is a disk catalogue and disk utility for owners of the Roland
  8. S330, S50, and S550 that use IBM compatible computers.
  9.  
  10. What can it do for you?
  11. =======================
  12.  
  13. Samdisk has the following features:
  14.  
  15.     a) Can read sampler diskettes into a standard DOS file on either
  16.        your hard disk or other floppy disks.
  17.  
  18.     b) Can write the sampler disk image file back onto any 720K capable
  19.        diskette. This diskette can be formatted either by the sampler
  20.        or by standard DOS utilities.
  21.  
  22.     c) Can produce a listing of the diskette's type (S330, S-50,
  23.        S550), title (if any), subtitle (if any), patches, and tones.
  24.  
  25.     d) Can produce a simple multiple disk catalogue.
  26.  
  27.     e) Can produce a multiple disk catalogue using a binary record
  28.        format (provided below) so that other programs may be used (or
  29.        WRITTEN) to manipulate your sampler disk data.
  30.  
  31.     f) Can duplicate multiple copies of a sampler disk with just one
  32.        read pass.
  33.     
  34.  
  35. What do I want from this?
  36. =========================
  37.  
  38. Well, typically I despise guiltware. I hate it when every Tom, Dick,
  39. and Harriet has their hand out for the latest/greatest directory program.
  40. What I'd like to suggest is this:
  41.  
  42.     o - If you use/like the program, PLEASE at least let me know.
  43.  
  44.     o - Since one of the main reasons for writing the program was to make
  45.         our sample disks transportable over telecommunicatios media, I'd
  46.     like to see some disks uploaded to Internet servers or Compuserve.
  47.     True, the files are large, but with FTP and 9600 baud modems (even
  48.     2400 baud modems), over the net disk transfers aren't too painful.
  49.  
  50.     o - I'd love more samples. If you could shoot me a disk or two with
  51.         your favorite samples, I'd REALLY appreciate that.
  52.  
  53.     o - If you're TRULY tickled, I could always use a little extra lunch
  54.         money - whatever. Please - nothing over $20, as this isn't about
  55.     making a profit; it's about getting samples between displaced
  56.     users, and about finding that harmonica sample in a stack of disks
  57.     at 1:30 AM.
  58.  
  59. Samdisk Modes
  60. =============
  61.  
  62. READ MODE (default)
  63. -------------------
  64.  
  65. Example: samdisk
  66.      samdisk -f outfile
  67.      samdisk -d a -f outfile
  68.          etc.
  69.  
  70. Read mode is the default state for samdisk. In this mode, a sampler
  71. diskette in the default samdisk drive is read sector by sector, and
  72. the output is deposited into a sampler disk image file (default is 
  73. 'samdisk.out'). 
  74.  
  75.  
  76. WRITE MODE (-w mode)
  77. --------------------
  78.  
  79. Example: samdisk -wf last.dsk
  80.  
  81. This is the logical inverse of READ MODE. A sampler disk image file is
  82. read from your hard/floppy disk, and the sectors are written back onto
  83. a 720K diskette in the samdisk drive. Note that diskettes formatted
  84. either by DOS or by the sampler may be used. Note also that the
  85. sampler doesn't like 1.44 MB floppies (or 5 1/4"), but samdisk will
  86. let you write to any of them.
  87.  
  88.  
  89. REPLICATE MODE (-r mode)
  90. ------------------------
  91.  
  92. Example: samdisk -r
  93.  
  94. This is merely a single read followed by one or more write operations.
  95. You will be asked if you wish to make multiple copies, and will be
  96. prompted at the appropriate time to insert a new 720K diskette. This
  97. is a great way to make duplicates.
  98.  
  99.  
  100. LIST MODE (-l mode)
  101. -------------------
  102.  
  103. Example: samdisk -l
  104.  
  105. This mode will present an ASCII display of the sampler disk's mode
  106. (i.e. S330, S-50, S550, or ????), title (if amy), subtitle (if any),
  107. patch names, and tone names. The format is:
  108.  
  109. *******************************************************************************
  110. ===============================================================================
  111. Title:    S-330     - System Disk      [2]      Multi Patch     by Roland
  112.  Type: S330
  113. -------------------------------------------------------------------------------
  114. Patch P11: Drums             Tone T11: Kick          Tone T31: B.Mari-L
  115. Patch P12: Slap Bass         Tone T12: Snare         Tone T32: B.Mari-H
  116. Patch P13: Fretles Bass      Tone T13: Tom           Tone T33: EP-1    
  117. Patch P14: Bras Section      Tone T14: Hihat-O       Tone T34: EP-2    
  118. Patch P15: AltoSax Solo      Tone T15: Hihat-C       Tone T35: EP-3    
  119. Patch P16: E.Piano           Tone T16: Ride          Tone T36: EP-4    
  120. Patch P17: J.Wind Bell       Tone T17: Crash         Tone T37: EP-5    
  121. Patch P18: Marimba           Tone T18: Handclap      Tone T38: EP-6    
  122. Patch P21: Slap Bass sw      Tone T21: ThmbBass      Tone T41: Sax-1   
  123. Patch P22: S.Bass uni        Tone T22: PullBass      Tone T42: Sax-2   
  124. Patch P23: FrtlsBas uni      Tone T23: Fretless      Tone T43: Sax-3   
  125. Patch P24: Brass dual        Tone T24: Brass-L       Tone T44: Sax-4   
  126. Patch P25: Brass+Sax         Tone T25: Brass-M       Tone T45: Sax-5   
  127. Patch P26: Marimba+Bell      Tone T26: Brass-H       Tone T46: Sax-6   
  128. Patch P27: E.Piano uni       Tone T27: J.W.Bell      Tone T47: Sax-7   
  129. Patch P28: Bell Piano        Tone T28: ???           Tone T48: Sax-8   
  130.  
  131. *******************************************************************************
  132.  
  133.  
  134. CATALOGUE MODE (-c mode)
  135. ------------------------
  136.  
  137. Example: samdisk -cf sdisks.cat
  138.  
  139. Catalogue mode is like the list mode, except that it may also be sent to
  140. a file (using the -f option), and that it will cyclically ask for more
  141. diskettes until you indicate that you are done. When using a file for
  142. output, if it already exists, it will be appended to. This way you can
  143. stop cataloging and continue again at a later time.
  144.  
  145. BINARY MODE (-b option)
  146. -----------------------
  147.  
  148. Example: samdisk -bf records.bin
  149.  
  150. The binary mode is JUST like catalogue mode, except that rather than
  151. writing an ASCII version of the disk's contents, a binary record is
  152. written for each disk catalogued. This builds a primitive database
  153. that may be manipulated by programs you write (or possibly some
  154. commercial packages that allow specification of the record structure).
  155.  
  156. The format of each record is as follows:
  157.  
  158. Field    Size    Contents
  159. -----   ----    -------------------------------------------------------
  160.   1      5    Type. "S550", "S-50", "S330", or "????". NULL
  161.         terminated.
  162.  
  163.   2     13    Title (13 chars, NULL terminated)
  164.  
  165.   3      52     Subtitle (51 chars, NULL terminated)
  166.  
  167.   4    208    Patchnames (16 names x 13 chars, each NULL terminated)
  168.  
  169.   5    288    Tone names (32 names x 9 chars, each NULL terminated)
  170.  
  171.  
  172. If you do write programs (such as sorters, cross referencers, and
  173. lookup tools), please share them with us.
  174.  
  175.  
  176. Other command line options
  177. ==========================
  178.  
  179. -f FILENAME    
  180. -----------
  181.  
  182. Example: samdisk -wf woof
  183.  
  184. Allows you to specify that the output of read (or input of write)
  185. operations be sent to a file other than 'samdisk.out'.
  186.  
  187. -d DISKDRIVE
  188. ------------
  189. Example: samdisk -d A
  190.  
  191. Allows you to specify that the default samdisk drive be other thabn
  192. 'B:'.
  193.  
  194.  
  195. Caveats
  196. ======= 
  197.  
  198. I have noticed that when using a disk cache program, operations can be
  199. slowed down when cataloguing if the floppy is cached. The reason for
  200. this is that the cache program tries to grab as much of the floppy as
  201. it can when the disk is inserted. If doing a list, catalogue, or
  202. binary operation, this is extreme overkill, as only a small part of
  203. the diskette needs to be read. Also, I'm not sure why, but many times
  204. the caching program will not detect the changed diskette and re-read
  205. into it's internal sector buffer. This may be because these aren't DOS
  206. formatted disks, and the cache doesn't recognize them.
  207.  
  208. Remember to use 3.5 720K diskettes. We may be able to cheat and use
  209. 1.44's in the future, but for now the sampler doesn't like the higher
  210. density diskettes. Covering the 'high density' hole on the HD
  211. diskettes may work, but no promises.
  212.  
  213.  
  214. Application ideas
  215. =================
  216.  
  217. Some of the things that samdisk will allow you to do:
  218.  
  219. o - Create disk image files of all of your sampler disks so you can
  220.     compress them and roll them off to low cost backup tapes on your
  221.     PC.
  222.  
  223. o - Ship sampler diskettes over modems or networks to other users.
  224.  
  225. o - Network sample archive servers for Roland sample users are now
  226.     feasible.
  227.  
  228. o - Send catalogues of your disk collection to others so that you can
  229.     swap non-duplicate samples.
  230.  
  231. o - Use the binary mode and your programming talents to develop the
  232.     ultimate sample disk manager utility.
  233.  
  234.  
  235. Contact information
  236. ===================
  237.  
  238. If you have problems, questions, bugs, or some new ideas, I can be 
  239. reached at any of the following:
  240.  
  241. Compuserve: 76703,4230
  242. Internet  : pete@wlbr.imsd.contel.com
  243. U.S. Mail : Pete Lyall, 6180 Wisteria St., Simi Valley, CA 93063
  244. Work (GTE): (805) 372-5493
  245.  
  246. Enjoy the program, and PLEASE - let's get some samples flowing!
  247.  
  248.